package edu.scau.mis.pos.config;


import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * OpenAPI配置
 * SwaggerV3配置类
 * 基本应用Controller无需进行任何配置
 */
//@Configuration
//public class OpenApiConfig {
//    /**
//     * 配置OpenAPI
//     * 文档UI访问地址：
//     * http://localhost:8081/swagger-ui/index.html
//     *
//     * @return
//     */
//    @Bean
//    public OpenAPI openAPI() {
//        return new OpenAPI()
//                .info(new Info()
//                        .title("MIS-Project接口文档")
//                        .description("SpringBoot3项目集成OpenAPI接口文档")
//                        .version("v1"))
//                .externalDocs(new ExternalDocumentation()
//                        .description("项目API文档")
//                        .url("/"));
//    }
//}





@Configuration
public class SwaggerConfig {
    /**
     * Knife4j 是为 Java MVC 框架集成 Swagger 生成 Api 文档的增强解决方案。
     * 文档UI访问地址：
     *          http://localhost:8080/doc.html#/home
     * @return
     */
    @Bean
    public OpenAPI customOpenAPI() {
        Info info = new Info()
                .title("MISP课程项目Clothing API")
                .version("1.0")
                .description("信息系统开发综合实践课程示例项目")
                .contact(new Contact().name("LuoJiaXun"));
        return new OpenAPI().info(info);
    }
}